home *** CD-ROM | disk | FTP | other *** search
/ Eagles Nest BBS 8 / Eagles_Nest_Mac_Collection_Disc_8.TOAST / Developer Environments / MacApp301#8 / MacApp 3.0.1• / Release Notes / MacApp 3.0.1 QuickStart / MacApp 3.0.1 QuickStart
Encoding:
Text File  |  1992-06-17  |  10.1 KB  |  9 lines  |  [ONLN/HLX2]
  1. MacApp® 3.0.1                                ®
  2. QuickStart
  3. This release of MacApp requires MPW 3.2 or later and CFront 3.2 or later.  It will not work with MPW 3.1.  If your computer has enough memory, setting the RAM Cache to 96K or higher will speed up MPW significantly.
  4. Installing
  5.  
  6.  
  7. To install MacApp on your system, do the following:
  8.     0.    Open the MacApp 3.0.1 folder on the CD.
  9. 1.    Drag the folder named “MacApp 3.0.1 (Hard Disk Ready)” to your hard disk. This folder contains MacApp 3.0.1 with two pre-built libraries: debug and no-debug.
  10.     The other folder named “More Libraries” contains several other pre-built MacApp 3.0.1 libraries. To install any of the pre-built libraries, just drag them from the “More Libraries” folder to the “Libraries” folder in the MacApp folder on your own hard disk.
  11. 2.     Drop the file “UserStartup•MacApp” from your MacApp folder to your MPW folder, and delete the file “MacApp_Folder” from your MPW folder (if present).
  12.         
  13. 3.     Launch MPW.  UserStartup•MacApp will automatically be executed.  You will be asked to find the MacApp folder.
  14.     4.    Optionally, create a folder to hold your Application source files, Rez input file,
  15.         and make file and place it in the MacApp folder.  The naming conventions
  16.         for your application's files are:
  17.         
  18.         MYourApp.cp/p        // The optional Main program
  19.         UYourApp.h/p        // The optional interface part of your application unit
  20.         UYourApp≈.cp/.inc≈.p    // The optional include file[s] that contain the
  21.                         // implementation of the unit.
  22.     OR ---------------------
  23.         YourApp.cp/p        // The Main program.  See Nothing.p for an
  24.                         // example.
  25.     AND --------------------
  26.         YourApp.r            // The optional Rez input file.  Default.r will be used
  27.                         // if you do not supply an input file
  28.         YourApp.MAMake        // The optional Make file.
  29.                         
  30. If you prefer to use a different naming convention, you will need to create a  YourApp.MAMake file.
  31.         
  32. Building
  33. To build your own non-debug version of the MacApp library:
  34.     1.     In MPW, set your directory to MacApp library folder:
  35.         directory "{MacApp}Libraries"
  36.     
  37.     2.     In MPW, type
  38.         MABuild -Autobuild
  39. The default build options for MABuild will build you a no-debug library that requires System 7.0.
  40. To build a debug version of the MacApp library:
  41.     1.     In MPW, set your directory to MacApp library folder:
  42.         directory "{MacApp}Libraries"
  43.     
  44.     2.     In MPW, type
  45.         MABuild -Autobuild -Debug
  46. Please refer to Debugging MacApp Programs later in these release notes for more information concerning debug MacApp applications.
  47. To build a  version of the MacApp library suitable for use with SourceBug or SADE:
  48.     1.     In MPW, set your directory to MacApp library folder:
  49.         directory "{MacApp}Libraries"
  50.     
  51.     2.     In MPW, type
  52.         MABuild -Autobuild -Sym -Names
  53.         or  optionally:
  54.         MABuild -Autobuild -Sym -Names -Debug
  55.         to use both the MacApp debugger and SourceBug/SADE.
  56. To build your application:
  57.     1.    You may need to create a “.MAMake” file.  See the MacApp Reference Manual,
  58.         or the Calc sample program to learn how.
  59.     2.     In MPW, set your directory to your Application folder:
  60.         directory "{MacApp}MyApp Folder"
  61.     
  62.     3.     In MPW, type
  63.         MABuild YourApp -NoPasLoad
  64.         
  65. where YourApp is the name of your application.  The -NoPasLoad option is still recommended if your application is Pascal based because of an occasional problem in previous releases of the Pascal compiler and its usage of load dump files.  This will build a non-debug version of the application.
  66. To build a debug version type:
  67.         MABuild YourApp -Sym -Names
  68.         or
  69.         MABuild YourApp -Sym -Names -Debug -NoPasLoad
  70.         
  71. The first time you build an application, Rez will run after the link to create your
  72. application's resources.  Rez will not run again unless you change the Rez input file (YourApp.r).
  73.  ◊#ˇ ˇˇˇˇ#◊ 
  74. d,Times
  75. .°dONLNd)*A~+HZMacApp
  76.     °dONLNd3~>Ö)T®
  77. °dONLNd)ÖAø) 3.0.1°dONLNd)⁄AÌ(Z¯
  78.     °dONLNd3Ì>Ù)®
  79. °dONLNdM*\g(xH
  80. QuickStart
  81. °dONLNd#h*tı*`This release of MacApp requires MPW 3.2 or later and CFront 3.2 or later.  It will not work with°dONLNdÑt*ÄÒ* YMPW 3.1.  If your computer has enough memory, setting the RAM Cache to 96K or higher will°dONLNdfiÄ*å¥* speed up MPW significantly.
  82. °dONLNd˙§*≥_*'
  83. Installing
  84. °dONLNdø*À%*3To install MacApp on your system, do the following:°dONLNd<◊N„X+$0.°dONLNd?◊r„:)$'Open the MacApp 3.0.1 folder on the CD.°dONLNdgÔN˚X(l1.°dONLNdjÔr˚˙)$NDrag the folder named “MacApp 3.0.1 (Hard Disk Ready)” to your hard disk. This°dONLNdπ˚rÏ* Nfolder contains MacApp 3.0.1 with two pre-built libraries: debug and no-debug.°dONLNd    rÚ*OThe other folder named “More Libraries” contains several other pre-built MacApp°dONLNdYr+„* S3.0.1 libraries. To install any of the pre-built libraries, just drag them from the°dONLNd≠+r7˚* R“More Libraries” folder to the “Libraries” folder in the MacApp folder on your own°dONLNd7rC¢*
  85. hard disk.°dONLNd ON[[(wl2. °dONLNdOr[‡)$FDrop the file “UserStartup•MacApp” from your MacApp folder to your MPW°dONLNdV[rgÌ* Nfolder, and delete the file “MacApp_Folder” from your MPW folder (if present).°dONLNd®sN[(õl3. °dONLNd¨srÙ)$LLaunch MPW.  UserStartup•MacApp will automatically be executed.  You will be°dONLNd˘rã*  asked to find the MacApp folder.°dONLNdóN£X(øl4.°dONLNdór£Â)$ROptionally, create a folder to hold your Application source files, Rez input file,°dONLNds£rØŒ* Hand make file and place it in the MacApp folder.  The naming conventions°dONLNdæØrª* !for your application's files are:°dONLNd«r”¿*
  86. MYourApp.cp/p°dONLNdÙ«”å)ê// The optional Main program°dONLNd”rfl∫(˚ê UYourApp.h/p°dONLNd!”fl˜)ê7// The optional interface part of your application unit°dONLNd[flr΄(êUYourApp≈.cp/.inc≈.p°dONLNdpflΑ)ê0// The optional include file[s] that contain the°dONLNdßΘä* // implementation of the unit.°dONLNd«Nµ(+lOR ---------------------°dONLNd‚r∂+$ YourApp.cp/p°dONLNd—)ê*// The Main program.  See Nothing.p for an°dONLNd!'6* // example.°dONLNd.3N?∫([lAND --------------------°dONLNdI?rK¶+$     YourApp.r°dONLNdU?K¯)ê7// The optional Rez input file.  Default.r will be used°dONLNdìKW¶* %// if you do not supply an input file°dONLNdªcroŒ(ãêYourApp.MAMake°dONLNdÀcoy)ê// The optional Make file.°dONLNdÌ{*á(£H]If you prefer to use a different naming convention, you will need to create a  YourApp.MAMake°dONLNdKá*ì=* file.+    BMacApp 3.0.1 QuickStart)œ
  87. 030-1998-B)¥Page )1ˇ
  88. ‰◊#ˇ ˇˇˇˇ#◊ 
  89. d,Times
  90. .°dONLNd)*8[+HTBuilding
  91. °dONLNd    D*PM*:To build your own non-debug version of the MacApp library:°dONLNdE\Nh[+$1. °dONLNdI\rhp)$4In MPW, set your directory to MacApp library folder:°dONLNdÄhrt* directory "{MacApp}Libraries"°dONLNd°ÄNå[(®l2. °dONLNd•Ärå∂)$ In MPW, type°dONLNd¥årò‘* MABuild -Autobuild°dONLNd«§*∞˘(ÃHaThe default build options for MABuild will build you a no-debug library that requires System 7.0.°dONLNd)º*»*/To build a debug version of the MacApp library:°dONLNdZ‘N‡[+$1. °dONLNd^‘r‡p)$4In MPW, set your directory to MacApp library folder:°dONLNdï‡rÏ* directory "{MacApp}Libraries"°dONLNd∂¯N[( l2. °dONLNd∫¯r∂)$ In MPW, type°dONLNd…r˙* MABuild -Autobuild -Debug°dONLNd„*(„(DH[Please refer to Debugging MacApp Programs later in these release notes for more information°dONLNd?(*4Ë* %concerning debug MacApp applications.°dONLNde@*L∫*RTo build a  version of the MacApp library suitable for use with SourceBug or SADE:°dONLNdπXNd[+$1. °dONLNdΩXrdp)$4In MPW, set your directory to MacApp library folder:°dONLNdÙdrp* directory "{MacApp}Libraries"°dONLNd|Nà[(§l2. °dONLNd|rà∂)$ In MPW, type°dONLNd(àrî* MABuild -Autobuild -Sym -Names°dONLNdI†r¨¥*or  optionally:°dONLNd[¨r∏?* %MABuild -Autobuild -Sym -Names -Debug°dONLNdɃr–Ç*3to use both the MacApp debugger and SourceBug/SADE.°dONLNd∑‹*˧(HTo build your application:°dONLNd”ÙNX+$1.°dONLNd÷ÙrÍ)$JYou may need to create a “.MAMake” file.  See the MacApp Reference Manual,°dONLNd#r 6* (or the Calc sample program to learn how.°dONLNdMN$[(@l2. °dONLNdQr$u)$6In MPW, set your directory to your Application folder:°dONLNdä$r0#*  directory "{MacApp}MyApp Folder"°dONLNdÆ<NH[(dl3. °dONLNd≤<rH∂)$ In MPW, type°dONLNd¡HrT * MABuild YourApp -NoPasLoad°dONLNdfl`*lÙ(àH]where YourApp is the name of your application.  The -NoPasLoad option is still recommended if°dONLNd=l*xfl* ]your application is Pascal based because of an occasional problem in previous releases of the°dONLNdõx*Ñfi* ]Pascal compiler and its usage of load dump files.  This will build a non-debug version of the°dONLNd˘Ñ*êa* application.°dONLNdú*®∫*To build a debug version type:+    -MacApp 3.0.1 QuickStart(Ò‘Page )2ˇ◊#ˇ ˇˇˇˇ#◊ 
  92. d,Times
  93. .°dONLNd5rA+ê]MABuild YourApp -Sym -Names°dONLNdMrY|*or°dONLNd#Yrew* -MABuild YourApp -Sym -Names -Debug -NoPasLoad°dONLNdTq*}ü(ôHSThe first time you build an application, Rez will run after the link to create your°dONLNd®}*â¯* bapplication's resources.  Rez will not run again unless you change the Rez input file (YourApp.r).(ÒQMacApp 3.0.1 QuickStart(Ò‘Page )3ˇ